home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / raq101.zip / RAQUOTE.DOC < prev    next >
Text File  |  1992-01-14  |  6KB  |  141 lines
  1.  
  2.  
  3.  
  4.  
  5.                            Remote Access Quote Maker
  6.  
  7.                                 Lige F. Hensley
  8.                                 January 11, 1992
  9.                                  Version 1.01
  10.  
  11.  
  12.  
  13.       
  14.  
  15.  
  16.                *** THIS FILE IS NOT FORMATTED FOR PRINTING ***
  17.     This program is shareware, it has NO WARRANTY and no guaruntee.  Although I have tested this program
  18. throughly, you can never know what may happen in different configurations.
  19. I have used it on a 2 line Remote Access BBS running LANtastic 4.0.  RAQUOTE
  20. does NOT supported file locking, but you shouldn't need it to unless you are
  21. doing something weird.
  22.      You can use this program for a month, without registration.  If you find
  23. it even remotely useful, send me 5 bucks, and it's your forever.  Because I
  24. don't believe in high shareware costs, this gets you all future versions. 
  25. BUT I am NOT going to mail you a disk everytime.  This would easily go over
  26. 5 dollars in postage alone.  So, what I'll do is mail you a key code that
  27. goes into the RAQUOTE.CFG file.  This will work on ALL FUTURE VERSIONS.  And
  28. in the odd event that I would want to change the key scheme.  Then I will
  29. split the bill for a new version on disk to you via US postal.  You can get
  30. future versions from my BBS (PITA-BBS) or when you happen to run accross it
  31. somewhere.
  32.      What registering RAQUOTE will do is give you color.  I hate crippleware
  33. with a passion.  But I can understand the reasoning behind it.  So, RAQUOTE
  34. will run with all the whistles and bells without being registered.  But it will
  35. not do anything in color.  All the files it creates will be straight .ASC 
  36. unless registered.  Then you get color and any ANSI enhancements that I might
  37. put in future versions.  Enough plugging for money.
  38.  
  39.      Packing List:
  40.      (NOTE: You may NOT alter this acrhive in any way.  NO BBS ADS, etc. 
  41.       all they do is take time and money.)
  42.    
  43.      RAQUOTE.EXE     RAQUOTE executable file.
  44.      RAQUOTE.CFG     Configuration file.
  45.      RAQUOTE.DOC     This document.
  46.      RAQUOTE.CTL     Special day quote file.
  47.      RAQUOTE.DAT     Text file containing quote data.
  48.      RAQUOTE.CNT     Number of the next quote.
  49.         PITA.BBS     My BBS ad.  (Well I WROTE it!!!)
  50.  
  51.  
  52.  
  53.      RAQUOTE is fully customizable.  By altering the RAQUOTE.DAT file you
  54. can add your own quotes or delete ones you don't like.  Another option is
  55. to specify another .DAT file in the config file and use RAQUOTE as a "DAY
  56. IN HISTORY" program.
  57.  
  58. The format of the .DAT file must be as follows:
  59.  
  60. LINE 1:  This is the quote (or history story) in a single line, NO carriage
  61. returns.  If it is shorter than 80 characters, it will be centered, if it is
  62. longer then the text will wrap around.  But not a WORD-WRAP, so test your
  63. quotes on screen first.
  64.  
  65. LINE 2:  This is the credit line, put whoever said the thing here.  Or whatever
  66. you want.  Also centered in necessary
  67.  
  68.      You can force RAQUOTE to display a certain quote by setting RAQUOTE.CNT to 
  69. the number you want the next time RAQUOTE is run.
  70.      RAQUOTE creates a file (specified in the RAQUOTE.CFG file) that you use
  71. as you wish.  Some people may want RAQUOTE to make there WELCOME file while
  72. some may use there maintenance batch file to merge it with there existing
  73.  WELCOME file.  It's up to you.
  74.      In the CONFIG file there are nine color codes.  If you have not registered
  75. RAQUOTE then these must be set to 0.  If they are not 0 then I can't guarntee
  76. what will happen.  You are taking matters into your own hands.  When you do
  77. register RAQUOTE these codes become active and I won't recommend leaving them
  78. as zeroes.  The format for these are as follows:
  79. There should be nine numbers here.  The first three control the "message"
  80. that goes before the quote.
  81. The second three control the quote itself.  
  82. The third three control the "said by" line.
  83.  
  84. The first number of any set controls intensity as follows:
  85. 0  normal characters
  86. 1  High-intensity characters (bright)
  87. 5  Blinking characters
  88.  
  89. The second number of any set controls foreground color as follows:
  90. 30 Black
  91. 31 Red
  92. 32 Green
  93. 33 Yellow
  94. 34 Blue
  95. 35 Magenta
  96. 36 Cyan
  97. 37 White
  98.  
  99. The thrid number of any set controls the background color, just add 10 to 
  100. the number above.
  101.      
  102.  
  103. INSTALLING & RUNNING RAQUOTE
  104. ----------------------------
  105.      Basically, RAQUOTE can be installed anywhere.  BUT there are a couple of           
  106. things you have to do.  RAQUOTE.EXE and RAQUOTE.CNT must, MUST, be in the 
  107. same directory.  If not then ERROR!  When the number in RAQUOTE.CNT exceeds 
  108. the number of quotes, you'll get a blank quote.  For those with like 10 
  109. quotes, I suggest you get more.  For those with 10,000 this is for you!  
  110. Anyway it is up to YOU to manage this.  I have a bunch of quotes in there 
  111. already.  ALSO keep RAQUOTE.CTL in the same directory.  If you don't use it  
  112. then keep the dates at 0 or something like December 98 or something.  Other
  113. than that put the other files wherever just make sure they are right in the
  114. .CFG file.
  115.      Running RAQUOTE is fast and simple.  An example on my BBS is:
  116.  
  117.      RAQUOTE RAQUOTE.CFG
  118.  
  119.      The config file is specified on the command line.  You can out the full
  120. path and filename there if it is elsewhere.  I like to keep all my programs
  121. in it's own directory, put it's up to you.
  122.      I have included as much error checking as possible.  I really hate those
  123. RUNTIME ERROR: 0000:1244 124 @$%$#^  things.  I have TRIED to crash this 
  124. sucker but to no avail.  (no this is not a challenge either!)
  125.  
  126.  
  127.      Since I don't think it's necessary, I haven't added an easy to use sysop 
  128. interface.  I figure that this should be easy enough to use.  But who 
  129. knows.  I may decide to do it anyway.  I have some ideas to improve this 
  130. already.  Oh well....
  131.  
  132. Please address any comments or suggestions or whatever to:
  133. Lige F. Hensley
  134. 10080 South 400 East
  135. Markleville, IN 46056
  136.  
  137. or to 
  138.  
  139. PITA-BBS
  140. (317) 640-9759
  141.